Resource URL: /platform/<<version=5>>/cluster/nodes/<LNN>/drives/<DRIVEID>

    Overview: This resource provides information about a specific drive on a
              specific node, such as the model, serial number, and location of
              the drive in the node.  LNN in the resource path is the desired
              node's LNN.  DRIVEID is the desired drive's ID.

     Methods: GET

********************************************************************************

Method GET: Retrieve drive information.

       URL: GET /platform/<<version=5>>/cluster/nodes/<LNN>/drives/<DRIVEID>

Query arguments:
timeout=<number> Request timeout

GET response body schema:
{
  "type": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "type": "object", 
      "properties": {
        "total": {
          "type": "integer", 
          "description": "The total number of nodes responding."
        }, 
        "nodes": {
          "items": {
            "type": "object", 
            "description": "Information about this node's drives.", 
            "properties": {
              "id": {
                "minimum": 0, 
                "type": "integer", 
                "description": "Node ID of the node reporting this information.", 
                "maximum": 4294967295
              }, 
              "status": {
                "required": false, 
                "minimum": 0, 
                "type": "integer", 
                "description": "Status of the HTTP response from this node if not 200.  If 200, this field does not appear.", 
                "maximum": 4294967295
              }, 
              "lnn": {
                "minimum": 0, 
                "type": "integer", 
                "description": "Logical node number of the node reporting this information.", 
                "maximum": 4294967295
              }, 
              "drives": {
                "items": {
                  "type": "object", 
                  "description": "Drive information.", 
                  "properties": {
                    "bay_group": {
                      "type": "string", 
                      "description": "The name of the bay group this drive belongs to."
                    }, 
                    "lnum": {
                      "type": "integer", 
                      "description": "This drive's logical drive number in IFS."
                    }, 
                    "baynum": {
                      "type": "integer", 
                      "description": "Numerical representation of this drive's bay."
                    }, 
                    "purpose_description": {
                      "type": "string", 
                      "description": "Description of this drive's purpose."
                    }, 
                    "handle": {
                      "type": "integer", 
                      "description": "Drive_d's handle representation for this drive"
                    }, 
                    "serial": {
                      "type": "string", 
                      "description": "Serial number for this drive."
                    }, 
                    "wwn": {
                      "type": "string", 
                      "description": "The drive's 'worldwide name' from its NAA identifiers."
                    }, 
                    "logical_block_length": {
                      "type": "integer", 
                      "description": "Size of a logical block on this drive."
                    }, 
                    "ui_state": {
                      "type": "string", 
                      "description": "This drive's state as presented to the UI."
                    }, 
                    "physical_block_length": {
                      "type": "integer", 
                      "description": "Size of a physical block on this drive."
                    }, 
                    "firmware": {
                      "type": "object", 
                      "description": "Drive firmware information.", 
                      "properties": {
                        "desired_firmware": {
                          "type": "string", 
                          "description": "This drive's desired firmware revision."
                        }, 
                        "current_firmware": {
                          "type": "string", 
                          "description": "This drive's current firmware revision"
                        }
                      }
                    }, 
                    "pending_actions": {
                      "items": {
                        "type": "string"
                      }, 
                      "type": [
                        "array", 
                        "null"
                      ], 
                      "description": "This drive's current outstanding actions. For example, \"add\" or \"firmware_update\"."
                    }, 
                    "media_type": {
                      "type": "string", 
                      "description": "String representation of this drive's media type."
                    }, 
                    "interface_type": {
                      "type": "string", 
                      "description": "String representtation of this drive's interface type."
                    }, 
                    "blocks": {
                      "type": "integer", 
                      "description": "Number of blocks on this drive."
                    }, 
                    "devname": {
                      "type": "string", 
                      "description": "This drive's device name."
                    }, 
                    "chassis": {
                      "type": "integer", 
                      "description": "The chassis number which contains this drive."
                    }, 
                    "purpose": {
                      "type": "string", 
                      "description": "This drive's purpose in the DRV state machine."
                    }, 
                    "y_loc": {
                      "type": "integer", 
                      "description": "This drive's y-axis grid location."
                    }, 
                    "x_loc": {
                      "type": "integer", 
                      "description": "This drive's x-axis grid location."
                    }, 
                    "present": {
                      "type": "boolean", 
                      "description": "Indicates whether this drive is physically present in the node."
                    }, 
                    "locnstr": {
                      "type": "string", 
                      "description": "String representation of this drive's physical location."
                    }, 
                    "model": {
                      "type": "string", 
                      "description": "This drive's manufacturer and model."
                    }
                  }
                }, 
                "type": "array", 
                "description": "List of the drives in this node."
              }, 
              "error": {
                "required": false, 
                "type": "string", 
                "description": "Error message, if the HTTP status returned from this node was not 200."
              }
            }
          }, 
          "type": "array", 
          "description": "The responses from the individual nodes involved in this request."
        }, 
        "errors": {
          "items": {
            "type": "object", 
            "properties": {
              "status": {
                "minimum": 0, 
                "type": "integer", 
                "description": "HTTP Status code returned by this node.", 
                "maximum": 4294967295
              }, 
              "message": {
                "type": "string", 
                "description": "More detailed description of the error."
              }, 
              "code": {
                "type": "string", 
                "description": "The general meaning of the status code."
              }, 
              "lnn": {
                "minimum": 0, 
                "type": "integer", 
                "description": "Logical node number of the node reporting this error.", 
                "maximum": 4294967295
              }
            }
          }, 
          "type": "array", 
          "description": "A list of errors encountered by the individual nodes involved in this request, or an empty list if there were no errors."
        }
      }
    }
  ]
}
